home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / dosutils / ntfsdos.zip / README.TXT < prev   
Text File  |  1996-09-13  |  14KB  |  344 lines
  1. ======================================================================
  2.  
  3. NTFS File System Driver for DOS/Windows V1.2 (read-only)
  4. Copyright (C) 1996 Mark Russinovich and Bryce Cogswell
  5.  
  6. Last modified September 11, 1996
  7.  
  8. ======================================================================
  9.  
  10. NTFSDOS.EXE is a network file system redirector for DOS/Windows 
  11. that is able to recognize and mount NTFS drives for transparent
  12. access.  It makes NTFS drives appear indistinguishable from standard 
  13. FAT drives, providing the ability to navigate, view and execute programs 
  14. on them from DOS or from Windows, including from the Windows 3.1 File 
  15. Manager and Windows 95 Explorer.
  16.  
  17.  
  18. Please read this entire file before contacting us for help.  
  19.  
  20.  
  21. Availability
  22. ============
  23.  
  24. The latest version of NTFSDOS can be found at:
  25.  
  26.     http://www.ntinternals.com
  27.  
  28.  
  29. Sample Output
  30. =============
  31.  
  32. Here is sample output from an NTFSDOS session under DOS 7.0 (Windows 95):
  33.  
  34. C:\ntfsdos>ntfsdos
  35.  
  36. NTFS File System Redirector for DOS/Windows V1.2 (read-only)
  37. Copyright (C) 1996 Mark Russinovich and Bryce Cogswell
  38.  
  39. Initialized 500KB of XMS cache.
  40.  
  41. Mounting NTFS partition(0x80:3) as drive: H
  42.  
  43. C:\ntfsdos>h:
  44.  
  45. H:\>dir
  46.  
  47.  Volume in drive H is ntfs
  48.  Directory of H:\
  49.  
  50. EMACS          <DIR>        03-16-96  8:31a emacs
  51. FILEMON        <DIR>        04-18-96  3:30p filemon
  52.                <DIR>        05-01-96  1:20p newlongfilename
  53. NTICE          <DIR>        03-30-96  8:18a NTICE
  54. PAGEFILE SYS    28,311,552  04-07-96 12:16p pagefile.sys
  55. PROGRA~1       <DIR>        03-30-96  5:20a Program Files
  56. RECYCLER       <DIR>        03-30-96  5:36a RECYCLER
  57. TEMP           <DIR>        05-15-96 12:58a temp
  58. USERS          <DIR>        03-16-96  3:27a users
  59. WIN32APP       <DIR>        03-16-96  3:27a win32app
  60. WINNT          <DIR>        03-30-96  8:41a WINNT
  61. WINNT35        <DIR>        05-15-96 12:58a WINNT35
  62.          1 file(s)     28,311,552 bytes
  63.         11 dir(s)     388,284,416 bytes free
  64.  
  65. H:\>
  66.  
  67. ----------------------------------------------------------------------
  68.  
  69.  
  70. Enhancements over V1.1
  71. ======================
  72.  
  73. NTFSDOS V1.2 has the following improvements over V1.1:
  74.  
  75.     - Support for NT 4.0 formatted drives
  76.     - Command line options for cache sizing and drive mapping
  77.     - Support for large drives (>2GB). If extended INT13 services
  78.           are present in the BIOS, NTFSDOS will use them to access drives.
  79.         - Conflicts with MSCDEX fixed. NTFSDOS can now co-exist with
  80.           Microsoft's real-mode CD-ROM driver.
  81.     - Drive detection fixed. NTFSDOS no longer confuses HPFS drives 
  82.       for NTFS (finally!).
  83.     - Several minor bug fixes.
  84.  
  85.  
  86. Contents of Package
  87. ===================
  88.  
  89. README.TXT  - this readme
  90. NTFSDOS.EXE - DOS/Windows NTFS file-system driver
  91. NTFSHLP.VXD - helper VxD needed only for long filename support in
  92.               Windows 95
  93.  
  94.  
  95. Installation and Use
  96. ====================
  97.  
  98. To use NTFSDOS, simply execute it from the DOS command line (DOS
  99. 5.0 or greater is required), or from your AUTOEXEC.BAT. Executing 
  100. NTFSDOS before Windows is started will create NTFS drives that 
  101. are visible globally once inside Windows. Executing NTFSDOS in a DOS box 
  102. means that the NTFS drives only exist within the DOS box where NTFSDOS 
  103. was executed.
  104.  
  105. When NTFSDOS starts, it will scan all hard-disk partitions on
  106. your system to look for NTFS drives. It will mount all NTFS drives
  107. it finds as unique DOS logical drive letters, and will inform you
  108. as it does so. 
  109.  
  110. If you run NTFSDOS under DOS 7.0, NTFS drives will support long filename 
  111. calls *even before Windows starts*.  To propagate this support into 
  112. Windows 95, NTFSDOS automatically has Windows run the NTFSHLP.VXD VxD 
  113. device driver. No changes to SYSTEM.INI or the registry are necessary 
  114. for this to occur - NTFSDOS will detect when Windows 95 starts and 
  115. load the driver without user-intervention. You need NTFSHLP.VXD only
  116. if you will be running NTFSDOS with Windows 95.
  117.  
  118. NTFSDOS implements its own caching, and uses one of two types of
  119. memory, depending on how your system is configured. Its first
  120. choice is to use XMS memory for caching, as this minimizes demands
  121. placed on conventional memory. If you start NTFSDOS before Windows,
  122. then HIMEM.SYS, which can be found in the WINDOWS directory under 
  123. Windows 95 or the DOS directory under Windows 3.1, or its equivalent, 
  124. must be started before NTFSDOS. If NTFSDOS does not detect an XMS
  125. server, it will resort to allocating 64KB of conventional memory for
  126. its cache. In either case, it will inform you of its action.
  127.  
  128. NTFSDOS takes three command line parameters. The /D parameter lets you 
  129. specify which driver letter NTFSDOS should start at when it determines
  130. where to mount an NTFS drive. The /C option lets you override the
  131. default XMS cache size. The /V option directs NTFSDOS to print some
  132. messages detailing the drives it looks at the memory it allocates. 
  133. The syntax for these parameters is:
  134.  
  135.     /D:<letter>    Specifies drive to start mounting at
  136.     /C:<size>    Specifies size of XMS cache in KB
  137.     /V        Verbose 
  138.  
  139. Example:
  140.     NTFSDOS /D:e /C:1024
  141.  
  142. This command has NTFSDOS start scanning for available drive letters at
  143. drive letter 'e' and indicates that it should create a 1MB XMS cache.
  144.  
  145. There is no way to unload NTFSDOS from memory once it has started.
  146.  
  147.  
  148. If You Have Problems Running NTFSDOS
  149. ====================================
  150.  
  151. * NTFSDOS does not recognize my NTFS drive
  152.  
  153. NTFSDOS does not handle cluster sizes > 4K on NT 4.0 formatted drives. This
  154. is rare, since NTFS compression does not handle these cluster sizes either.
  155.  
  156. NTFSDOS requires that disks be accessible via BIOS, using the INT 13 or
  157. extended INT 13 services. In some cases, SCSI drives may not be fully 
  158. accessible without a DOS device driver (see your SCSI adapter documentation).
  159.  
  160. * NTFSDOS uses too much conventional memory
  161.  
  162. Some people have complained that NTFSDOS is a memory hog.  Unfortunately,
  163. this fact is largely imposed on us by the architecture of NTFS itself 
  164. (sorry, but its a *little* more complicated than FAT, and much more memory
  165. intensive), coupled with our desire to provide reasonable performance
  166. across a wide variety of NTFS installations.  In general, the footprint
  167. of NTFSDOS increases largely with the clustersize of the largest NTFS 
  168. partition, and slightly with the number of NTFS volumes mounted.
  169.  
  170. * Accessing an NTFSDOS drive causes a hang or crash
  171.  
  172. NTFSDOS does not support disk striping. Further, it cannot handle drives 
  173. that are on partitions extending beyond the 2GB boundary, or that 
  174. are larger than 2GB in size, UNLESS the computer's BIOS has extended
  175. INT 13 support for the drives in question. The latter restrictions are due to 
  176. limitations in standard disk BIOS code that prevent it from addressing 
  177. sectors 2GB or more from the start of a disk.
  178.  
  179. NTFSDOS has not been thoroughly bullet-proofed against corrupt NTFS
  180. drive data structures, so it may cause Windows to crash or hang
  181. when it runs into problems. To insure that a crash or hang is due
  182. to a problem with NTFSDOS rather than your NTFS drive, be sure to
  183. chkdsk the drive from Windows NT and try NTFSDOS again.
  184.  
  185. * Starting programs or loading files seems very slow
  186.  
  187. Access of large compressed files may be noticeably slower than of
  188. their non-compressed versions.
  189.  
  190. * File times are not correct when running under DOS 7.0 without Windows 95
  191.  
  192. This problem is due to the fact that NTFS and LFN FAT time stamps are 
  193. stored in Coordinated Universal Time (UTC), which is based on Greenwich Mean
  194. Time, and Windows 95 automatically converts times stamps returned by LFN 
  195. calls to local time.  Since local time zone information is not accessible 
  196. outside of Windows 95, running NTFSDOS under DOS 7.0 without Windows 95 
  197. results in the display of unadjusted times. 
  198.  
  199. * Programs complain about not being able to find files when they are 
  200.   there
  201.  
  202. A directory listing of files that have no short filename will result
  203. in the short filename field of the listing being blank (see the file,
  204. "newlongfilename," in the sample listing above). Changing the current
  205. directory to a path where any component of the pathname does not
  206. have a short filename will result in all short filename calls failing
  207. while in the directory. This makes most Windows 3.1 and DOS programs and 
  208. many DOS commands (e.g. MORE) inoperative in these directories. However, 
  209. LFN calls are supported in these directories.
  210.  
  211. * Data read from a file appears to be corrupt
  212.  
  213. Since this work is based on reverse-engineering rather than official
  214. Microsoft specifications (which are reportedly available under special
  215. circumstances for large amounts of money), we do not guarantee data
  216. integrity of NTFSDOS drives. This is especially important if you are
  217. considering using NTFSDOS as a file backup utility.
  218.  
  219. * Files or directories seem to be missing
  220.  
  221. Remember that files and directories that were created with no DOS 8.3
  222. short filenames will not be visible if you are running DOS versions earlier
  223. than 7.0.
  224.  
  225. * You get the message "No drive letter to mount NTFS partition..."
  226.  
  227. If NTFSDOS complains that it cannot mount a drive because there
  228. are no available drive letters, you must find the line in your CONFIG.SYS
  229. that begins with "LASTDRIVE=". If you do not find one, then add one. Set
  230. the LASTDRIVE variable to a letter that is greater, by the number
  231. of NTFS drives on your system, than the largest drive letter you normally
  232. have under DOS/Windows. For example, if the highest drive letter normally
  233. in use is E: and you have two NTFS drives, set LASTDRIVE to G: with a 
  234. statement in CONFIG.SYS like: 
  235. LASTDRIVE=G: 
  236. If you still get the message then increment the letter and try again. 
  237. Remember to reboot after every change to CONFIG.SYS.
  238.  
  239. * You get the message "Could not allocate XMS or conventional cache"
  240.  
  241. Memory usage on your machine is so high that NTFSDOS could not allocate
  242. 64KB for a conventional cache. Try removing unnecessary TSRs and drivers
  243. and/or running a DOS memory optimizer or manager.
  244.  
  245. * XCOPY does not work in a DOS box
  246.  
  247. XCOPY will not work on NTFS drives that are mounted in DOS boxes under 
  248. Windows 95 (e.g. running NTFSDOS in a DOS box). This is because you 
  249. cannot run Windows programs off of non-global drives, and under Windows 95, 
  250. XCOPY starts the Windows console program XCOPY32.EXE.
  251.  
  252.  
  253. Reporting Bugs
  254. ==============
  255.  
  256. When you report a bug (see Reaching Us, below), please provide the following
  257. information about your system:
  258.  
  259.     - disk types (IDE, etc.)
  260.     - disk and partition sizes
  261.     - BIOS version
  262.     - drive sizes and formats
  263.     - version of NT that was used to format NTFS drives
  264.     - version of NTFSDOS you are using
  265.     - an output dump of NTFSDOS run with the /V (verbose) option.
  266.     - version of DOS and/or Windows you are running NTFSDOS on
  267.  
  268.  
  269. Implementation
  270. ==============
  271.  
  272. NTFSDOS scans the system's partition tables looking for partitions
  273. that have the NTFS attribute byte. When it finds one, it looks for an
  274. unused DOS driver letter and registers a network drive on it. After
  275. it completes the drive search it hooks the network redirector
  276. interrupt and goes resident. Requests come into NTFSDOS as full path
  277. names, or continuations of a previous directory traversal (as with
  278. findnext), so it proceeds to determine where, based on NTFS internal
  279. data structures, the target file is located. When it retrieves the
  280. header for the target file it can determine where the file's data is
  281. located, and read it when it receives requests to do so.
  282.  
  283. To provide long filename support (LFN), NTFSDOS hooks INT 21/AH=0x71
  284. calls and implements LFN functionality when it sees an LFN call. 
  285. Under Windows 95, NTFSHLP.VXD is required to send LFN calls down to 
  286. the NTFSDOS for it to process; otherwise NTFSDOS would not see LFN calls 
  287. since Windows assumes DOS redirected drives do not provide LFN support.
  288.  
  289. NTFSDOS also uses the INT 2F/11 and INT 13 APIs. Otherwise the magic is 
  290. just memory and cache management plus interpretation of the NTFS on-disk 
  291. structures.
  292.  
  293.  
  294. Write-Access NTFSDOS
  295. ====================
  296.  
  297. A write-access NTFSDOS will not be appearing for several months.
  298. However, in the interim we do plan on a release of NTFSDOS 1.5. V1.5 will 
  299. allow some write capability aimed at aiding in dead system recovery. It
  300. will cost $35 and allow file renaming and over-write capability. This 
  301. is useful in cases where a driver is causing an NT system to crash during 
  302. boot, or a system file has become corrupted so that NT can't get far enough 
  303. to run chkdsk. 
  304.  
  305. Send us e-mail if you wish to be notified when new versions are released,
  306. and we will add you to our mailing list.
  307.  
  308.  
  309. Source Code Availability
  310. ========================
  311.  
  312. We are licensing royalty free, the complete source code to NTFSDOS. Both 
  313. components, NTFSDOS.EXE and NTFSHLP.VXD, are written in C. NTFSDOS.EXE 
  314. requires Microsoft Visual C 1.5 and NTFSHLP.VXD requires MS VC 2.0 or greater
  315. to build. Compiling NTFSHLP.VXD also requires Vireo's VtoolsD 2.0 or greater.
  316.  
  317. Our code was written from scratch, is well documented, and handles many 
  318. disk layouts and configurations (compressed files being one) that the Linux 
  319. NTFS code does not. In addition, the file system redirector support is far 
  320. more advanced than that found in Undocumented DOS. Contact us for details 
  321. if you are interested.
  322.  
  323.  
  324. Reaching Us
  325. ===========
  326.  
  327. We would appreciate any feedback you have concerning this utility
  328. including suggestions and bug reports. Mark can be reached at
  329. mark@osr.com, and Bryce can be reached at cogswell@cs.uoregon.edu.
  330.  
  331.  
  332. Acknowledgments
  333. ===============
  334.  
  335. We thank everybody that e-mailed us with bug reports and other feedback. 
  336.  
  337. Significant understanding of the NTFS file system layout was derived by 
  338. studying the Linux-based NTFS driver code maintained by Martin von Loewis. 
  339. We acknowledge his indirect contribution to this endeavor.
  340.  
  341. Andrew Schulman, et. al.'s, book, Undocumented DOS 2nd Edition 
  342. (Addison-Wesley), was invaluable in providing network redirector 
  343. information necessary for implementing NTFSDOS.
  344.